home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 737 / prlabel / prlabel.doc < prev    next >
Text File  |  1995-03-18  |  5KB  |  143 lines
  1.  
  2.  
  3.                                  PrLabel
  4.                                  =======
  5.                                  
  6.                           Version 1.1  17.01.92
  7.                           Version 1.2  14.09.92
  8.  
  9.  
  10.                             SciTech  Software
  11.                               23, Stag Leys
  12.                                  Ashtead
  13.                                  Surrey
  14.                                 KT21 2TD
  15.  
  16.                          Tel.: +44 (0372) 275775
  17.  
  18.  
  19.  
  20.         PrLabel is shareware with a suggested donation of £5.00.
  21.  
  22.         The interface is created using STSLib, a library of 3D
  23.         gadget and menu building routines available from SciTech
  24.         Software for £20.00.
  25.  
  26.  
  27.  
  28.  
  29. PrLabel is a utility to print labels on laser printer label sheets. 
  30. Three patterns of labels are supported: 3x8, 2x8 and 2x7, defaulting to the
  31. 3x8 format.
  32.  
  33. V1.2 now allows address lists to be read from, or written to, files. The
  34. record delimiter may be specified and defaults to a comma. The program
  35. can thus be used to read files written by a database, etc.
  36.  
  37. Running the Program
  38. ===================
  39. From the CLI, the program is invoked with:
  40.  
  41.    PrLabel [-38][-28][-27][-s<c>]
  42.  
  43. where -38 is the same as the default label format, -28 and -27 select the 
  44. 2x8 and 2x7 formats respectively and -s is followed by a character which
  45. specifies the delimiter (default: ,).
  46.  
  47.  
  48. From the Workbench, the Icon tooltype may be set to one of:
  49.  
  50.    FORMAT=38
  51.    FORMAT=28
  52.    FORMAT=27
  53.    SEPARATOR=,
  54.  
  55. where FORMAT=38 is the same as the default and FORMAT=28 and FORMAT=27 
  56. select the 2x8 and 2x7 formats respectively. The default separator is
  57. a comma, any other sensible character (e.g. |, \, +, etc.) may be used.
  58. To alter the icon's tooltype, select the icon with a single click, then 
  59. choose the Info item from the Workbench's menu.
  60.  
  61.  
  62. The PrLabel Window
  63. ==================
  64. If, when you run PrLabel, you obtain a message saying BuildBoolGadget() 
  65. needs a larger window, then you should select a smaller Screen Text font 
  66. (this applies only to AmigaDOS V2.0).
  67.  
  68. When PrLabel starts, a window is opened on the Workbench screen. The window 
  69. contains:
  70.  
  71. o  A group of gadgets on the left in the format specified.
  72. o  Seven text gadgets
  73. o  Three gadgets labelled NEXT, PREV and KILL
  74. o  One gadget labelled PRINT!
  75.  
  76. The first of the text gadgets will be activated and will allow you to enter 
  77. text. When you press RETURN, the next text gadget will be activated 
  78. allowing you to enter an address without having to touch the mouse.
  79.  
  80. If you have entered a single address, you can select the label position at 
  81. which it will be printed by clicking the relevent label on the format group.
  82. Clicking the gadget again will deactivate it. If you select more than one 
  83. label position, the label will be printed at all the selected positions.
  84.  
  85. By clicking the NEXT gadget, the text gadgets will be cleared allowing you 
  86. to enter a second address. You can repeat this process as many times as you 
  87. desire. The addresses will be printed in the order you entered them, but 
  88. they will only be printed at the currently selected label positions. Thus 
  89. some of the addresses may not be printed. The addresses will be printed in 
  90. order running down (rather than across) the label positions.
  91.  
  92. When multiple addresses have been entered, each will be printed only once
  93. even if the number of label positions selected exceeds the number of 
  94. addresses entered.
  95.  
  96. The PREV gadget will allow to to step back through the adresses and correct 
  97. mistakes while the KILL gadget will delete the currently displayed address. 
  98. If KILL has no effect, it is because there is only one address left.
  99.  
  100. Finally PRINT! will cause the labels to be printed.
  101.  
  102.  
  103. Menus
  104. =====
  105. PrLabel has only a Project menu with the items:
  106.  
  107. o  Open
  108. o  Save
  109. o  About
  110. o  Quit
  111.  
  112. The Open item displays a file requester in which a pre-existing file of 
  113. addresses is specified. The file must contain 1 label to each line with the
  114. records (i.e. name and lines of the address) separated by the delimiter 
  115. character specified with the tooltype or on the command line character.
  116.  
  117. The Save item displays a file requester in which a file of addresses to
  118. be written is specified. The file will contain 1 label to each line with the
  119. records (i.e. name and lines of the address) separated by the delimiter
  120. character specified with the tooltype or on the command line character.
  121.  
  122. The About item displays information about the program.
  123.  
  124. The Quit item (or the window's close gadget) exits the program.
  125.  
  126.  
  127. Re-compiling
  128. ============
  129. To recompile and link the program, you will require the demo. or commercial
  130. version of STSLib. The demo. version is on Fish Disk 599. To link
  131. completely, the Heath file requester from Fish Disk 41 is required. However,
  132. this requester is only used if you do not have the ASL requester. 
  133. Consequently, if you have AmigaDOS V2.04, or above, the Heath requester 
  134. will not be used and you may safely ignore the error message produced by 
  135. Blink.
  136.  
  137. To include the Heath requester you should alter the makefile. Search for
  138. #HEATH and comment out the OFILES line which is currently used and 
  139. un-comment the one which is currently commented. You must also uncomment 
  140. the compile lines used to compile the Heath requester code. Copy 
  141. safeclose.c and getfile.c from AmigaLibDisk41:GetFile and run make to 
  142. compile these and re-link.
  143.